package com.xx.pinball.framwork;

/**
 * @author xx
 *
 */
public interface TouchHandler {
    /** 
     * Returns whether the finger with the given pointer ID
     * is down. The first finger to touch the screen will 
     * get ID 0, the next will get ID 1 and so on. In general,
     * any finger going down will get the first free ID available.
     * 
     * @param pointer the pointer ID
     * @return whether the finger with the ID is down.
     */
    public boolean isTouchDown(int pointer);
    
    /** 
     * Returns the x-coordinate of the finger with the given pointer ID
     * is down. The first finger to touch the screen will 
     * get ID 0, the next will get ID 1 and so on. In general,
     * any finger going down will get the first free ID available.
     * 
     * @param pointer the pointer ID
     * @return the x-coordinate in the coordinate system of the View this handler is registered with.
     */
    public int getTouchX(int pointer);
    
    /** 
     * Returns the y-coordinate of the finger with the given pointer ID
     * is down. The first finger to touch the screen will 
     * get ID 0, the next will get ID 1 and so on. In general,
     * any finger going down will get the first free ID available.
     * 
     * @param pointer the pointer ID
     * @return the y-coordinate in the coordinate system of the View this handler is registered with.
     */
    public int getTouchY(int pointer);
}
